home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / BUERGUTL.ARJ / FBR.ARC / FBR176.DOC < prev    next >
Text File  |  1989-10-10  |  19KB  |  629 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                          FBR - File Backup / Restore
  28.                                  Version  1.7
  29.                                 February  1990
  30.  
  31.                      (c) Copyright Vernon D. Buerg 1985-90
  32.                                 ALL RIGHTS RESERVED
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57. FBR - File Backup / Restore
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                 Notice
  68.                                 ------
  69.  
  70.         This is a development test release of FBR. Use these
  71.         programs at your own risk.  Although they have  been
  72.         extensively tested,  I take no responsiblity for any
  73.         losses.
  74.  
  75.  
  76.  
  77.                              NOT PUBLIC DOMAIN
  78.                              -----------------
  79.  
  80.         This document and the FBR programs are the personal property
  81.         of:
  82.  
  83.                         Vernon D. Buerg
  84.                         139 White Oak Circle
  85.                         Petaluma, CA  94952
  86.  
  87.                         VOR BBS: (707) 778-8944
  88.                         Compuserve: 70007,1212
  89.  
  90.         FBR is distributed by me for your personal use. You may not
  91.         charge for distributing FBR. Commercial use of FBR is
  92.         prohibited.  Corporations and institutions may not use FBR
  93.         without first obtaining written permission. Sorry about that,
  94.         but if anyone is going to make a buck from this, it should be me.
  95.  
  96.  
  97.         Please let me know of any problems, criticisms, or suggestions.
  98.         Thank you.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112. FBR - File Backup/Restore                                            Contents
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                 Table of Contents
  121.                                 -----------------
  122.  
  123.                 Introduction ............................... 1
  124.  
  125.                 FB - File backup ........................... 2
  126.  
  127.                   Backup examples .......................... 3
  128.  
  129.                 FR - File restore .......................... 4
  130.  
  131.                   Restore examples ......................... 5
  132.  
  133.                 FS - File status ........................... 6
  134.  
  135.                 Operational notes .......................... 7
  136.  
  137.                 Version history ............................ 8
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168. FBR - File Backup / Restore                                             Page 1
  169.  
  170.  
  171.  
  172.  
  173.                             Introduction
  174.                             ------------
  175.  
  176.         FBR is a system of three small programs which perform the
  177.         backing up and restoring of files.  They are similar to the
  178.         DOS BACKUP/RESTORE utilities except that FBR can currently
  179.         only process one directory at a time.  It does, however, back
  180.         up all files in a directory, filling as many backup disks as
  181.         necessary.  The FBR backup and restore programs can select
  182.         files based upon 30 file specifications.
  183.  
  184.  
  185.  
  186.                              Programs
  187.                              --------
  188.  
  189.         The FBR system consists of these files:
  190.  
  191.             FB.COM   -  used to back up files
  192.             FR.COM   -  used to restore FBR files
  193.             FS.COM   -  to report on contents of FBR files
  194. |           FLH      -  FBR's Little Helper for multiple directories
  195.             FBR.DOC  -  this document
  196.  
  197.         It is recommended that the FR.COM program be copied to the
  198.         first diskette of each backup. This will insure that the
  199.         restore program is the correct one for restoring the files.
  200. |       The file name may include a version number, e.g. FB174.COM
  201.         instead of FB.COM for the backup program.
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223. FBR - File Backup / Restore                                             Page 2
  224.  
  225.  
  226.                         Backup - FB Command
  227.                         -------------------
  228.  
  229.         To back up files in a directory, use the FB.COM program.
  230.  
  231.  
  232. |   FB  [d:][\path][filespec] [filespec...] [/D] [/M] [/2] [/C] [/V] [/Z] [t:]
  233.  
  234.  
  235. |       At least one command line operand must be supplied. The /Z option
  236. |       tells FB to compress the files, resulting in fewer backup disks.
  237.  
  238.         If the first d:  (drive) operand is supplied, it specifies the
  239.         drive, and/or path, and/or a file specification for the files to
  240.         be backed up.  Only files matching the 'filespec' are processed.
  241.  
  242.         More than one 'filespec' may be supplied.  Separate each file
  243.         specification by a blank or a comma.
  244.  
  245.         The IBMDOS.COM, IBMBIO.COM, MSDOS.SYS, and IO.SYS files are
  246.         ignored.
  247.  
  248.         The last 't:' operand specifies the target drive, and it must be
  249.         the LAST operand.
  250.  
  251.         The /D operand specifies that all files on the target disk be
  252.         deleted before files are backed up to it.
  253.  
  254.         The /M operand specifies that only modified files are to be
  255.         backed up, i.e.  archive bit not set.
  256.  
  257.         The /2 operand specifies that the target drive is to alternate
  258.         from either B to A, or from A to B.  This allows backups to
  259.         continue while changing floppy diskettes.
  260.  
  261.         The /C operand specifies that the archive bit for each file
  262.         copied should be reset.
  263.  
  264.         The /V operand specifies that the DOS verify function should be
  265.         used.  This results in slower I/O but perhaps more peace of
  266.         mind.
  267.  
  268.         As each file is processed, a message is displayed telling you
  269.         the name of the file that has been copied.  You may abort the
  270.         back-up by pressing ESCape or control-C.
  271.  
  272.         When a backup drive fills, you are asked to ready another
  273.         diskette and to press any key.  To cancel the backup at this
  274.         point, press the ESCape key.  The state of the copied files is
  275.         unpredictable if you cancel the back up.
  276.  
  277.  
  278. FBR - File Backup / Restore                                             Page 3
  279.  
  280.  
  281.  
  282.         Backup Examples:
  283.         ---------------
  284.  
  285.         o  If the current drive is C: and the current directory
  286.            is \ME, then to backup all of the C:\ME files
  287.            onto two alternating drives, issue the following:
  288.  
  289.                 FB /2    -or-  FB C:\ME\*.* /2  B:
  290.  
  291.         o  To backup only files with an extension of COM or EXE:
  292.  
  293.                 FB *.COM *.EXE
  294.  
  295.         o  Backup two files from a directory on drive D, and delete
  296.            any files already on the backup diskette:
  297.  
  298.                 FB d:\subdir\file1.ext file2.ext b: /D
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333. FBR - File Backup / Restore                                             Page 4
  334.  
  335.  
  336.                             Restore - FR Command
  337.                             --------------------
  338.  
  339.         To restore files backed up by FB, use the FR.COM program.
  340.  
  341. |       FR  [d:][\path]  [filespec...]  [/2] [/R] [/U] [/V] [/Q] [/Z]
  342.  
  343.         The 'd:' operand specifies the drive which contains the FBR
  344.         files from FB.  If omitted, drive A is used.
  345.  
  346.         The \path operand identifies the FBR file to use for the
  347.         restore.  If omitted, the first FBR file found is used.
  348.         FR always restores the files to the current disk and
  349.         directory.
  350.  
  351.         Up to 30 "filespec" parameters may be supplied.  Only those
  352.         files which match one of the "filespecs" are restored.
  353.  
  354.         The '/2' operand specifies that two drives are to be used for
  355.         restoring files.  The request for readying drives alternates
  356.         from B to A, or from A to B.
  357.  
  358.         The '/V' option specifies that the system verify option is to be
  359.         set on.  Otherwise, verify is set off to improve speed.
  360.  
  361.         The '/R' option specifies that any existing copies of the files
  362.         be over-written.  If omitted, you will be asked whether or not
  363.         an existing file may be replaced.  This is the fastest method
  364.         of restoring files.
  365.  
  366.         The '/U' option specifies that only new files from the backup
  367.         set be restored.  A new file is one that does not already exist
  368.         in the target directory, or one that has a later file date and
  369.         time.
  370.  
  371.         Use the /Q switch to disbale beeps and bells.
  372.  
  373.         If you mount the wrong FBR disk, the program asks again for the
  374.         same disk number. Press ESCape or ctrl-C to abort.
  375.  
  376.         As each file is restored, a message is displayed telling you the
  377.         name of the file.  As a backup disk becomes completely read, you
  378.         are asked to ready another.  You may press the ESCape or
  379.         control-C at any time to cancel the restore operation.  All
  380.         files except the last one are valid.
  381.  
  382.         If the target disk runs out of space, the restore stops and the
  383.         last file may be unusable.
  384.  
  385.  
  386.  
  387. FBR - File Backup / Restore                                             Page 5
  388.  
  389.  
  390.         Each restored file has the same or later date, and the same file
  391.         attribute as the original (backup copy) of the file.  Existing
  392.         files are over-written if the /R option is used, or if the
  393.         backup copy of the file is newer and the /U option is used.
  394.  
  395.  
  396.         FR Examples:
  397.         -----------
  398.  
  399.         o  To restore the files from an FBR disk(s) in
  400.            drive B, use the following:
  401.  
  402.                 FR B:
  403.  
  404.  
  405.         o  Restore the subdirectory TEST which has an FBR file
  406.            name of @TEST@@@.#01
  407.  
  408.                 FR a:\test
  409.  
  410.  
  411.         o  To restore only files with an extension of COM or EXE:
  412.            that are newer:
  413.  
  414.                 FR *.COM *.EXE /U
  415.  
  416.  
  417.  
  418. FBR - File Backup / Restore                                             Page 6
  419.  
  420.                             Status - FS Command
  421.                             -------------------
  422.  
  423.         To determine the names of files backed up into FBR file(s), and
  424.         on which diskette they reside, use the FS.COM program.
  425.  
  426.                 FS  [d:][pathname] [filespec]  [/N]
  427.  
  428.         The single operand 'd:' specifies the drive which contains the
  429.         FBR file(s).  If omitted, drive A is assumed.
  430.  
  431.         If no 'pathname' is supplied, the directories for all FBR files
  432.         on the disk are displayed.  Otherwise, only those FBR files
  433.         which match the pathname are shown.
  434.  
  435.         Up to 30 file specifications may be supplied. If omitted, all
  436.         FBR file entries are displayed. If supplied, only those entries
  437.         that match one of the filespecs is displayed.
  438.  
  439.         It is not necessary to use the first disk of FBR files for FS to
  440.         display file status information.  The LAST diskette contains the
  441.         most accurate data regarding which diskettes that files are on.
  442.         If the 'Disk Pos' is given as '?', the diskette numbers are
  443.         estimates.
  444.  
  445.         For each file backed up by FB, one line of information is
  446.         displayed.  This includes the file name, create date, file size,
  447.         file attributes, and the diskette number.  The files are
  448.         displayed in alphabetical order unless the /N option is used,
  449.         then the files are listed in the physical order in which they
  450.         were backed up.
  451.  
  452.         If a file starts on one disk and ends on another, two volume
  453.         numbers are displayed, e.g.  01 02.
  454.  
  455.         When the screen fills, the message "more..." is displayed.  You
  456.         may enter ESCape or control-C, or the letter N to abort and
  457.         return to DOS.
  458.  
  459.  
  460.  
  461. FBR - File Backup / Restore                                             Page 7
  462.  
  463.                               Operational Notes
  464.                               -----------------
  465.  
  466.         The FB backup program creates one file on each disk that it
  467.         uses.
  468.  
  469.         The filename is of the form '@ppppppp.#nn',
  470.  
  471.              where 'nn' is a sequential volume number beginning with 01;
  472.              and 'ppppppp' is the name of the origin directory. For root
  473.              directories, the name also contains the drive letter.
  474.              For example, '@ROOTC@@.#01' is the first backup file for
  475.              the root directory of the disk from drive C.
  476.  
  477.         FB may not scratch the target disk.  It will use whatever space
  478.         is available for making its backup copies and ask for another
  479.         disk as needed.  Because the FBR filenames are taken from the
  480.         the origin directory name, more than directory may be backed up
  481.         onto one diskette.
  482.  
  483.         FB requires about 64K of memory but will use all available
  484.         memory if it needs to for storing directory information.
  485.  
  486.         FR restores files to the current drive and subdirectory.  This
  487.         is intentional as it yields more flexibility.
  488.  
  489.         I've noticed that FBR is about twice as fast as BACKUP, and that
  490.         the /2 option for using two drives is very helpful.  The amount
  491.         of disk space is about the same.
  492.  
  493.         The FBR files may reside on any type of disk supported by the
  494.         operating system.  That is, a floppy diskette may be backed up
  495.         to a fixed disk, if so desired.
  496.  
  497.         Since the FBR files are unique on any disk (or subdirectory)
  498.         there is no reason why they can not be sQueezed or ARCed for
  499.         transporting to other systems.  For example, an entire floppy
  500.         disk of files will most likely produce one FBR file that can be
  501.         compressed and then transmitted.
  502.  
  503.  
  504.  
  505. FBR - File Backup / Restore                                             Page 8
  506.  
  507.  
  508.                              More?
  509.                              -----
  510.  
  511.         FBR was written to satisfy my personal method of backup.  I'm
  512.         sure there are much better methods and programs, but FBR is
  513.         cheap (free), and it's easy for me to use.  I don't use it for
  514.         all my backup procedures, but it has saved me more than once.
  515.  
  516.         Future enhancements will allow processing all subdirectories in
  517.         the current directory, formatting of the target disks, and the
  518.         ability to add files to an existing FBR file.
  519.  
  520.         If you like FBR, let me know.  Otherwise I'll get bored with it
  521.         and forget all about it.
  522.  
  523.  
  524.  
  525. FBR - File Backup / Restore                                             Page 9
  526.  
  527.  
  528.                              Version History
  529.                              ---------------
  530.  
  531.         1.0 - October 28, 1985
  532.         1.1 - October 30, 1985
  533.                 - added /C and /V options to FB
  534.                 - subdirectory and IBMxxx.COM entries are excluded
  535.                   from the FBR files to save some space
  536.                 - fixed the ESCape (or ctrl-C) response to abort FB
  537.                 - changed FS to show two disk numbers for files which
  538.                   span volumes
  539.         1.2 - October 31, 1985
  540.         1.3 - November 12, 1985
  541.                 - the table at the beginning of each FBR file now contains
  542.                   the actual diskette number for each file, this makes
  543.                   this version incompatibile with previous versions, so
  544.                   it's a good idea to place FR.COM on each FBR disk.
  545.                 - FS now lists the file alphabetically, and if the last
  546.                   disk is used, the diskette numbers are accurate; otherwise
  547.                   the diskette number is calculated and may not be correct.
  548.                 - the FBR file name was changed to allow multiple directories
  549.                   to be backed up onto one disk; this also provides more
  550.                   information about what the FBR file contains.
  551.                 - the ESCape key can be used at any time during FB to abort
  552.                   the backup.
  553.         1.4 - December 7, 1985
  554.                 - FB may selectively back up files
  555.                 - FR may selectively restore files
  556.                 - FS processes all FBR files on the specified drive
  557.                 - the ESCape and control-C keys may be used at any
  558.                   time to abort an FBR program; control-break is not
  559.                   accepted
  560.         1.45 - January 25, 1986
  561.                 - correct path syntax for FR
  562.  
  563.         1.47 - February 2, 1986
  564.                 - corrections to FR for multiple volumes
  565.  
  566.         1.49 - February 16, 1986
  567.                 - corrections to FR for large files spanning two disks
  568.                 - add path operand to FS
  569.                 - remove BIOS specific display routines from FS
  570.  
  571.         1.50 - March 13, 1986
  572.                 - corrections to FR for selective file restore
  573.                 - add display options to FS
  574.  
  575.         1.53 - May 21, 1986
  576.                 - add /D option to FB to delete files on target disks
  577.                 - exclude MSDOS.SYS and IO.SYS
  578.                 - change FB to process files in ascending size order
  579.  
  580.  
  581.  
  582. FBR - File Backup / Restore                                             Page 10
  583.  
  584.  
  585.                              Version History (cont'd)
  586.                              ---------------
  587.  
  588.  
  589.         1.54 - June 14, 1986
  590.                 - add /V, /R and /U options to FR
  591.                 - display file names 5-up in FR
  592.                 - make FB smaller
  593.  
  594.         1.55 - April 7, 1987
  595.                 - correct problem with cross-linked clusters using /D
  596.                 - correct problems supplying filespecs to FB
  597.  
  598.         1.58 - July 30, 1987
  599.                 - FB: improve performance writing to target drive
  600.  
  601.         1.60 - Aug 1, 1987
  602.                 - FB: add display of file count, total bytes, and
  603.                       count of disks required
  604.                 - FB: improve file selection routines
  605.  
  606.         1.61 - Aug 4, 1987
  607.                 - FS: add filespec command line option
  608.                 - FR: replace file selection routines
  609.                 - FR: correct abort if wrong disk mounted
  610.                 - FR: correct restore of file after replying Y to
  611.                       "already exitts" message
  612.  
  613.         1.62 - Nov 11, 1987
  614.                 - FR: correct drive letter in mount message
  615.                 - FR: correct problem using 'd:\path' in command not
  616.                       using correct fbr filename
  617.  
  618.         1.63 - Mar 20, 1988
  619.                 - FR: correct problem restoring from multiple disks
  620.  
  621. |       1.73 - Mar 31, 1989
  622. |               - FB: added /Z option to compress files
  623. ||              - version 1.7 is not compatible with earlier versions
  624. |       1.74 - Apr 7, 1989
  625. |               - FB: added SHARE capabilty which allows you to back up
  626. |                 open files that are SHARED
  627. |       1.76 - Oct 10, 1989
  628. |               - corrections to compression routines
  629.